home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / utils / shell / gcal-1.001 < prev    next >
Encoding:
Text File  |  1996-11-16  |  6.9 KB  |  166 lines
  1. This is the file README for the `gcal' distribution, version 1.00.
  2.  
  3.  
  4. This file informs about the features of Gcal, a program for printing
  5. calendars, in an abridged draft.  Gcal displays a calendar for a month
  6. or a year, eternal holiday lists and fixed date warning lists, in many
  7. ways.  The program correctly omits the dates that were skipped when the
  8. current Gregorian calendar replaced the earlier Julian calendar.
  9.  
  10.  
  11. Its main advantages over BSD-`cal' and `calendar' are:
  12.  
  13.   * Some special calendar sheet formats.
  14.   * Variable number of year calendar sheet blocks.
  15.   * Adjustable highlighting of holidays and actual day.
  16.   * Variable starting day of week.
  17.   * Output of current days of year, concatenated current days of month and year.
  18.   * Output of fiscal years.
  19.   * Output of lists or ranges of months or years.
  20.   * Sorted output of eternal holiday lists, which are generated automatically.
  21.   * Sorted output of fixed date warning lists in MANY ways.
  22.   * Allows the use of date variables.
  23.   * Fixed date warning messages can be stored in several files.
  24.   * Default options can be stored in environment variable GCAL.
  25.   * Options and commands stored in response files can be preloaded.
  26.   * Uses either an external pager or a simple built-in pager.
  27.   * Detailed Texinfo reference manual.
  28.   * German, English and American version.
  29.   * Supports various computer platforms.
  30.   * Autoconf(igure) installation technology.
  31.   * Supports both UN*X short style options and GNU long style options.
  32.  
  33.  
  34. System requirements:
  35. --------------------
  36.   Compiler         : Any? [ANSI] C compiler (GCC, TCC, BCC, MSC, ZTC,
  37.                        WCC, XLC, []CC...)
  38.   Computer         : MS-DOS PC, OS/2 PC, Linux PC, Acorn, Atari ST,
  39.                        Amiga, Vax, most UN*X Workstations, perhaps
  40.                        some Mainframes
  41.   RAM              : Below 250 KByte(UN*X/OS2/MS-DOS) load size
  42.   Graphics adapter : None
  43.   Device driver    : [n]ansi.sys/ansi-terminal recommended, but not essential
  44.   Harddisk         : None
  45.  
  46.  
  47. Limitations:
  48. ------------
  49.   The date must be after 0 and before 10000 (means year in range 1...9999).
  50.     >  The current Gregorian calendar year is actually about 26.3 seconds
  51.     >  longer than the solar year, which means that by 4316 the calendar
  52.     >  will be one day ahead of the sun.
  53.     >  Some sort of correction obviously MUST be made.
  54.   I know that there will be an adjustment of some kind in 4316, but I am not
  55.   sure what it is to be.  So I don't respect this correction in Gcal yet !
  56.  
  57.  
  58. Some planned features are not supported yet (see the file TODO).  See
  59. the file NEWS for a summary of changes since version 0.28 or HISTORY
  60. for a complete summary of changes.  See the file INSTALL and SYMBOLS
  61. for compilation and installation instructions.  Some answers to frequently
  62. asked questions are given in the file INSTALL, please read it.  A list of
  63. all known bugs can be found in the BUGS file, a list of internal limitations
  64. in the LIMITATIONS file.  Inspect MANIFEST for a list of all files which are
  65. part of this distribution.
  66.  
  67.  
  68. If you use the GNU Autoconf technology, you can enable/disable several
  69. package options by calling the `configure' script with `--enable-FEATURE'
  70. `--disable-FEATURE' arguments.  These arguments are:
  71.  
  72.     --enable-feature=DIGIT+DIGIT+... where DIGIT is 1...6
  73.  
  74. (1) --enable-cath    Additional Catholic holidays.
  75. (2) --enable-debug   Includes some debugging code.
  76. (3) --enable-easci   Displaying using the extended ASCII character set.
  77. (4) --enable-ger     German texts, holidays and calendar style.
  78. (5) --enable-ushdy   U.S. specific holidays.
  79. (6) --enable-exit127 On help etc. terminate with exit status 127.
  80.  
  81.     --enable-greg-ref=YEAR  Year of Gregorian reform, either 1582 or 1752.
  82.  
  83.     --disable-hls    Never use highlighting sequences.
  84.     --disable-pager  Never use external or simple, internal pager feature.
  85.     --disable-rc     Never use fixed date warnings feature.
  86.     --disable-term   Never use libtermcap or libtermlib.
  87.  
  88. Here are some sample calls of configure script:
  89.  
  90.   ./configure --enable-feature=1+5+6                (for American users)
  91.   ./configure --enable-feature=1+6 --enable-ushdy   (same as above)
  92.   ./configure --enable-feature=1+4+6                (for German users)
  93.   ./configure --enable-feature=1+3+4+6              (for German Linux users)
  94.   ./configure --disable-term --enable-feature=...   (work around Termcap bug)
  95.  
  96.  
  97. Some words on how Gcal will manage the Gregorian reformation:
  98.  
  99.   If you configure Gcal for English users, the year of Gregorian
  100.   reformation is automatically set to 1752 and there is no need to
  101.   use the `--enable-greg-ref=1752' option.  But if you want to burn-in
  102.   the alternative year the Gregorian reformation have occured, run
  103.   `configure' in this way:
  104.  
  105.     ./configure --enable-greg-ref=1582 ...
  106.  
  107.   If you configure Gcal for German users, the year of Gregorian
  108.   reformation is automatically set to 1582 and there is no need to
  109.   use the `--enable-greg-ref=1582' option.  But if you want to burn-in
  110.   the alternative year the Gregorian reformation have occured, run
  111.   `configure' in this way:
  112.  
  113.     ./configure --enable-ger --enable-greg-ref=1752 ...
  114.  
  115.  
  116. This program does not require Termcap, but takes advantage of it
  117. when it is available.  You may want to get and install GNU Termcap
  118. first from /@prep.ai.mit.edu:pub/gnu/termcap-1.2.tar.gz, or better.
  119.  
  120.  
  121. Please send all comments and bug reports via electronic mail to:
  122.  
  123.    Thomas Esken <esken@uni-muenster.de>
  124.  
  125. or, if this fails, to bug-gnu-utils@prep.ai.mit.edu.
  126.  
  127. Bug reports should ideally include:
  128.     * The complete output of "gcal --version" (or the contents of gcal_def.h
  129.         and the Makefile if you can't get `gcal' to compile)
  130.     * The hardware and operating system (try "uname -a")
  131.     * The compiler used to compile (if it is gcc, use "gcc -v")
  132.     * A description of the bug behavior
  133.     * The command line given to `gcal', that triggered the bug
  134.  
  135.  
  136. Gcal is free software, you can redistribute it and/or modify it under
  137. the terms of the GNU General Public License as published by the `Free
  138. Software Foundation'; either version 2, or (at your option) any later
  139. version.  A copy of this license is provided under the name COPYING.
  140. Specific copyright conditions are part of Gcal now, see the file
  141. COPYING2 for more information.
  142.  
  143.  
  144. The latest version of Gcal is always available by ftp in
  145. prep.ai.mit.edu:/pub/gnu, or in any of the prep mirror sites:
  146.  
  147. - sources in gcal-*[.tar or .tar.Z or .tar.gz or .zip or .shar].
  148.  
  149.  
  150. The latest MSDOS sources/executables are always available from
  151. SimTel, the Coast to Coast Software Repository (tm), (available
  152. by anonymous ftp from the primary mirror site OAK.Oakland.Edu
  153. and its mirrors):
  154.  
  155. - SimTel/msdos/deskaccs/gcal-*.zip
  156. - SimTel/msdos/unixlike/gcal-*.zip
  157.  
  158.  
  159. Some ftp servers can automatically make a tar.Z from a tar file.
  160. If you are getting Gcal for the first time, you can ask for a
  161. tar.Z file instead of the much larger tar file.
  162.  
  163.  
  164. Many thanks to those who provided me with bug reports and feedback.
  165. See the files THANKS and HISTORY for more details.
  166.